### HCOPy...

The HCOPy system controls the output of screen information to an external device. Part of the functionality of this system is included in the File
menu.

Command tree: HCOPy

:DESTination

:DEVice

:LANGuage

[:IMMediate]

:ITEM

:ALL

:LOGO

[:STATe]

:MLISt

[:STATe]

:TIME

[:STATe]

:PAGE

:MARGin

:BOTTom

:LEFT

:RIGHt

:TOP

:ORIentation

:WINDow

### HCOPy:DESTination <string> | 'MMEM'

Selects a printer name or file as destination for the screen output.

<string> | | Printer name, string variable. One of the printers accessible from your PC.
'MMEM' | Print to file. The file name is defined via MMEMory:NAME . The command HCOPy:DEVice:LANGuage WMF | EWMF | BMP | PNG selects the file format.
*RST value | – Note: *RST does not overwrite the printer destination.
SCPI, Command Types | Confirmed, command or query.
Example: | `MMEM:NAME 'C:\Screenshots\PLOT1.BMP'` `Define a printer file name (without creating the file), assuming that .BMP is the current file format (see HCOPy:DEVice:LANGuage ).` HCOP:DEST 'MMEM'; HCOP Select 'Print to file' and create the printer file specified before.

#### HCOPy:DEVice:LANGuage
EMF | WMF | EWMF | BMP | JPG | PNG

Selects a file format for printer files. Selecting the format is recommended to ensure that the file defined via MMEMory:NAME
can be read or imported by an external application.

EMF, WMF, EWMF | Windows enhanced metafile format (vector-based, file extension *.emf). The parameter WMF is equivalent to EMF; a query returns EMF.
BMP | Windows bitmap
JPG | JPEG bitmap
PNG | Portable network graphics format
*RST value | BMP
SCPI, Command Types | Confirmed, command or query.
Example: | `HCOP:DEV:LANG BMP` `Select Windows bitmap format for printer files.` `MMEM:NAME 'C:\Screenshots\PLOT1.BMP'` `Define a printer file name and specify an existing directory (without creating the file).` HCOP:DEST 'MMEM'; HCOP Select 'Print to file' and create the printer file specified before.

#### HCOPy[:IMMediate]

Immediately initializes the print according to the current HCOPy setup parameters.

*RST value | –
SCPI, Command Types | Confirmed, no query.
Example: | `H`COP:DEST '<Printer_name>' Select the printer for the output of screen data. `HCOP` `Start printing.` ````

#### HCOPy:ITEM:ALL

Selects the complete screen contents to be printed, including the logo (HCOPy:ITEM:LOGO
), time (HCOPy:ITEM:TIME
), and the marker list (HCOPy:ITEM:MLISt
).

*RST value | After a reset, the complete information is printed; see commands for logo, time, marker list and settings.
SCPI, Command Types | Confirmed, no query.
Example: | `H`COP:ITEM:ALL Select the complete information to be printed. `HCOP` `Start printing.` ``

#### HCOPy:ITEM:LOGO[:STATe] <Boolean>

Qualifies whether or not the printed output contains the logo. The default R&S logo (file Logo.gif) is stored in the Resources\Images subdirectory of the NWA program directory and can be replaced by another logo.

<Boolean> | ON | OFF - Logo is included or excluded.
*RST value | OFF
SCPI, Command Types | Device-specific, command or query
Example: | `H`COP:ITEM:ALL Select the complete information to be printed. `HCOP:ITEM:LOGO ON; HCOP` `Include the logo in the printed output and start printing.`

#### HCOPy:ITEM:MLISt[:STATe] <Boolean>

Qualifies whether or not the printed output contains the information in the marker info field (marker list).

<Boolean> | ON | OFF - Marker list is included or excluded.
*RST value | OFF
SCPI, Command Types | Device-specific, command or query
Example: | `H`COP:ITEM:ALL Select the complete information to be printed. `HCOP:ITEM:MLISt ON; HCOP` `Include the marker list in the printed output and start printing.` ``

#### HCOPy:ITEM:TIME[:STATe] <Boolean>

Qualifies whether or not the printed output contains the current date and time.

<Boolean> | ON | OFF - Date and time is included or excluded.
*RST value | OFF
SCPI, Command Types | Device-specific, command or query
Example: | `H`COP:ITEM:ALL Select the complete information to be printed. `HCOP:ITEM:TIME ON; HCOP` `Include the data and time in the printed output and start printing .`

#### HCOPy:PAGE:MARGin:BOTTom <numeric_value>

Defines the distance between the bottom of the page and the bottom of the printed information.

<numeric_value> | Lower margin.
Range [def. unit] | 0.01 mm to 10000 mm [mm]
*RST value | 0.01 mm
SCPI, Command Types | Device-specific, command or query
Example: | `H` COP:PAGE:MARG:BOTT 10; TOP 10 Set an upper and a lower margin of 1 cm.

#### HCOPy:PAGE:MARGin:LEFT <numeric_value>

Defines the distance between the left edge of the page and the left edge of the printed information.

<numeric_value> | Left margin.
Range [def. unit] | 0.01 mm to 10000 mm [mm]
*RST value | 0.01 mm
SCPI, Command Types | Device-specific, command or query
Example: | `H` COP:PAGE:MARG:LEFT 10; RIGHT 10 Set an left and a right margin of 1 cm.

#### HCOPy:PAGE:MARGin:RIGHt <numeric_value>

Defines the distance between the right edge of the page and the right edge of the printed information.

<numeric_value> | Right margin.
Range [def. unit] | 0.01 mm to 10000 mm [mm]
*RST value | 0.01 mm
SCPI, Command Types | Device-specific, command or query
Example: | `H` COP:PAGE:MARG:LEFT 10; RIGHT 10 Set an left and a right margin of 1 cm.

#### HCOPy:PAGE:MARGin:TOP <numeric_value>

Defines the distance between the top of the page and the top of the printed information.

<numeric_value> | Upper margin.
Range [def. unit] | 0.01 mm to 10000 mm [mm]
*RST value | 0.01 mm
SCPI, Command Types | Device-specific, command or query
Example: | `H` COP:PAGE:MARG:BOTT 10; TOP 10 Set an upper and a lower margin of 1 cm.

#### HCOPy:PAGE:ORIentation
PORTrait | LANDscape

Defines the orientation of the printed page. Switching between LANDscape and PORTrait rotates the hardcopy result by 90 degrees. No other settings are changed.

PORTrait | | Short edge of the paper is the top of the page.
LANDscape | Long edge of the paper is the top of the page.
*RST value | PORTrait
SCPI, Command Types | Confirmed, command or query
Example: | `H` COP:PAGE:ORI LAND; HCOP Select landscape page orientation and start printing.

#### HCOPy:PAGE:WINDow
ACTive | ALL | SINGle

Defines the number of diagram areas per printed page.

ACTive | Print only active diagram area.
ALL | | All diagram areas are printed on one page.
SINGle | One diagram area per page.
*RST value | ALL
SCPI, Command Types | Confirmed, command or query
Example: | `H` COP:PAGE:WIND SING; HCOP Select one diagram area per page and start printing.